package com.kehutong.wxapi.service;

import com.kehutong.wxapi.request.ContactBatchSearchRequest;
import com.kehutong.wxapi.request.ContactSearchRequest;
import com.kehutong.wxapi.response.ContactBatchSearchResponse;
import com.kehutong.wxapi.response.ContactSearchResponse;
import com.kehutong.wxapi.service.impl.ContactServiceImpl;
import org.coraframework.inject.ImplementedBy;

/**
 * 通讯录搜索服务接口
 * @author: liukunlong
 * @date: 2021-03-08 19:08
 */
@ImplementedBy(ContactServiceImpl.class)
public interface ContactService {
    /**
     * 通讯录单个搜索
     * 请求地址：https://qyapi.weixin.qq.com/cgi-bin/service/contact/search?provider_access_token=ACCESS_TOKEN
     * @param contactSearchRequest 通讯录单个搜索请求对象
     * @return 通讯录单个搜索响应对象
     * @throws Exception 异常
     */
    ContactSearchResponse contactSearch(ContactSearchRequest contactSearchRequest) throws Exception;


    /**
     * 通讯录批量搜索
     * 请求地址：https://qyapi.weixin.qq.com/cgi-bin/service/contact/batchsearch?provider_access_token=ACCESS_TOKEN
     * @param contactBatchSearchRequest 通讯录批量搜索请求对象
     * @return 通讯录批量搜索搜索响应对象
     * @throws Exception 异常
     */
    ContactBatchSearchResponse contactBatchSearch(ContactBatchSearchRequest contactBatchSearchRequest) throws Exception;
}
